home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 015 / hp14.arc / PP14.DOC < prev   
Text File  |  1985-01-05  |  9KB  |  271 lines
  1. .PL255
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                               PP - the Page Printer
  26.  
  27.                                Copyright (c) 1986
  28.  
  29.                             Centurion Software Corp.
  30.                                3917 Garfield Drive
  31.                          Stone Mountain, Georgia  30083
  32.  
  33.                                  (404) 294-1103
  34.  
  35.  
  36.         I  License
  37.  
  38.              The Page Printer is distributed via the "fairware"  process, 
  39.              that  is,  anyone  may distribute the program,  but  if  the 
  40.              program  is  used,  the user is requested  to  pay  a  $5.00 
  41.              license fee.  This license fee is a "per user" fee, not  per 
  42.              processor, therefore, if you own 10 processors, simply  send 
  43.              $5.00  and  you may use the program on any or all  of  them.  
  44.              You  may  NOT sell, rent, lease or in any other  way  profit 
  45.              from  the  inclusion  of this program with  any  package  or 
  46.              bundle of software without a written commercial license from 
  47.              Centurion Software Corp.
  48.  
  49.         II  Current Version
  50.  
  51.              This documentation supports version 1.4 of the Page Printer.  
  52.              Any  earlier versions (1.0 - 1.3) are no  longer  supported.  
  53.              Version  1.4  provides  faster screen  displays.   No  other 
  54.              changes were made.
  55.  
  56.         III  Version revision history
  57.  
  58.              Version  1.0,  the  original release of  the  Page  Printer, 
  59.              supported the following options: Tab expansion, page length, 
  60.              top margin, bottom margin, line wrap.
  61.  
  62.              Version 1.1 added page offset (left margin), optional  print 
  63.              to screen, optional suppression of high bit, optional use of 
  64.              line feed characters in place of form feeds.
  65.  
  66.              Version  1.2  added  starting page,  ending  page  and  page 
  67.              numbering control.
  68.  
  69.              Version  1.3 added multiple printer support (LPT1, 2  &  3), 
  70.              compatability with MODE printer re-direction.
  71.  
  72.              Version 1.4 improved the speed of the screen displays by use 
  73.              of  a  public domain version of the printf  function.   This 
  74.              version does not allow redirection of the opening messages.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.                            PP - the Page Printer - 
  93.                  Copyright (c) 1985 - Centurion Software Corp.
  94.         IV  Command line format
  95.  
  96.              All  options  are specified in the command line.   A  single 
  97.              character,  preceded  by  a  slash,  indicates  the  option.  
  98.              Several  options must have a numeric  specifier  immediately 
  99.              following  the  character, with no space  intervening.   For 
  100.              example,   /w132  specifies  the  Width  option,  with   132 
  101.              becomming  the paper width.  The file to be printed  may  be 
  102.              preceded  by  a drive designator and/or  a  directory  path.  
  103.              Options  and  the file may be specified in any  order.   The 
  104.              program parses the options and interprets them accordingly.
  105.  
  106.              Sample command lines:
  107.  
  108.              pp /x4 /t5 /b8 abcd.c
  109.              pp /s /h help.doc /@4
  110.  
  111.         V  Options
  112.  
  113.              The  following paragraphs describe the options for the  Page 
  114.              Printer.
  115.  
  116.         /d#  Device to use.  This option specifies which of the three DOS 
  117.              printer  devices  to use.  The default is  1.   The  program 
  118.              appends  the  number  to  the  file  name  LPT,  which   DOS 
  119.              interprets as one of the 3 available line printers.  If  the 
  120.              printer  selected  is  not  available,  a  message  will  be 
  121.              displayed.
  122.  
  123.         /p#  Page  length.  Specifies the number of PRINTABLE  lines  per 
  124.              page.   The default is 66, for 11 inches of continuous  feed 
  125.              paper  at 6 lines per inch.  The top and bottom margins  are 
  126.              subtracted from this number to get the USABLE page size.
  127.  
  128.         /t#  Top margin.  Specifies the number of lines at the top of the 
  129.              page  to  reserve for a margin.  If the number of  lines  is 
  130.              greater than 2, then the program will print a header line in 
  131.              the  margin.   The header will be the file  name,  the  page 
  132.              number and the date and time that the print process started.  
  133.              The default is 3.
  134.  
  135.         /b#  Bottom margin.  Specifies the number of lines at the  bottom 
  136.              of  the page to reserve for a margin.  Nothing gets  printed 
  137.              in the bottom margin.  The default is 3.
  138.  
  139.         /x#  tab   eXpansion.   This  specifies  how  may   columns   are 
  140.              represented  by  each  tab character.   The  default  is  8.  
  141.              (Sorry, I wanted to use T for Tabs but T is for Top margin.)  
  142.  
  143.         /o#  Offset (left margin).  This specifies how may spaces are  to 
  144.              be  inserted at the beginning of each line during the  print 
  145.              process, to allow for holes to be punched, etc.  The default 
  146.              is 0.
  147.  
  148.  
  149.  
  150.  
  151.                            PP - the Page Printer - 
  152.                  Copyright (c) 1985 - Centurion Software Corp.
  153.         /w#  Width  (right margin).  This specifies how many  characters, 
  154.              including  the offset, may be placed across the  page.   The 
  155.              default is 80.
  156.  
  157.         /f#  First  page.  This specifies what page number is to  be  the 
  158.              first  page printed.  For this process, the printing  begins 
  159.              when  a  page number is greater than or equal  to  the  page 
  160.              specified.  All pages less than the number specified are not 
  161.              printed.   Since  the  file  is  dynamically  paged   during 
  162.              printing, the program must read through all preceding  pages 
  163.              before the actual printing begins.  The actual page  printed 
  164.              is affected by the /@ option (see below).
  165.  
  166.         /l#  Last  page.   This specifies what page number is to  be  the 
  167.              last  page  printed.   For this  process,  the  page  number 
  168.              printed  on the top of the page is the  determining  factor.  
  169.              The  actual  ending page is affected by the /@  option  (see 
  170.              below).  The default is 65,535 (2^16 - 1).
  171.  
  172.         /@#  start  page number @.  This specifies the page number to  be 
  173.              assigned  to the first page IN THE FILE.  The default is  1.  
  174.              This  parameter  affects the /f and /l options  (see  above) 
  175.              since both of these options operate on the page number to be 
  176.              printed.
  177.  
  178.         /h   High big inclusion.  This option tells the program to  print 
  179.              all  8 bits in each byte of the data file.  The  default  is 
  180.              that the high bit is suppressed, that is, forced to 0.  This 
  181.              suppression allows files created by WordStar to be  printed.  
  182.              Files  that  use  the IBM graphics character  set  above  7F 
  183.              hexadecimal  should  be printed with the /h  option  if  the 
  184.              printer being used can handle the full IBM character set.
  185.  
  186.         /s   Screen  print.   This tells the program to  display  to  the 
  187.              screen,  rather than any printer.  The defaults are  changed 
  188.              appropriately.  (This option was primarily used to test  the 
  189.              program,  since  I actually didn't have a  printer  attached 
  190.              during much of the development period.)
  191.  
  192.         /n   No  form  feeds.  This tells the program to use  line  feeds 
  193.              rather  than  form feeds to advance to the top of  the  next 
  194.              page.  This allows printers that do not respond to the  form 
  195.              feed character to be used.
  196.  
  197.              Note:  All options may be specified in either UPPER or lower 
  198.              case.  The same is true for the file.
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.                            PP - the Page Printer - 
  211.                  Copyright (c) 1985 - Centurion Software Corp.
  212.         VI  Future enhancements
  213.  
  214.              Future enhancements of the Page Printer will include:
  215.  
  216.              1)   Ability  to  read WordStar dot commands  and  make  the 
  217.              appropriate adjustments while printing.
  218.  
  219.              2)   Inclusion of printer setup strings, to  enable  various 
  220.              special  features, including lines per inch, characters  per 
  221.              inch, etc.
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                            PP - the Page Printer - 
  270.                  Copyright (c) 1985 - Centurion Software Corp.
  271.